Gradle 依赖管理api,compilyOnly区别

🧩 一、`compileOnly` 的定义

compileOnly 表示：

这个依赖只在编译阶段需要，但不会打包进最终的可执行产物（如 jar/war），也不会在运行时提供。

换句话说：

依赖方式	编译可见	运行可见	传递给下游模块	常见用途
implementation	✅	✅	❌	普通依赖，只在当前模块可见（推荐默认）
api	✅	✅	✅	公共依赖，暴露给依赖此模块的其他模块（常用于 library）
compileOnly	✅	❌	❌	只在编译期需要，如 Servlet API、Lombok、注解处理器等
runtimeOnly	❌	✅	❌	只在运行期需要，如 JDBC 驱动、日志实现
compileOnlyApi	✅	❌	✅	（很少用）与 compileOnly 类似，但会传递编译可见性给下游
annotationProcessor	✅（特殊阶段）	❌	❌	仅在编译期注解处理阶段需要，如 MapStruct、Dagger、Lombok

假设你写了一个 web 应用：

dependencies {
    compileOnly 'javax.servlet:javax.servlet-api:4.0.1'
    implementation 'org.springframework.boot:spring-boot-starter-web'
}

如果你写成 implementation：

场景	依赖示例	说明
Web 容器提供类库	`javax.servlet:servlet-api`	在容器（Tomcat、Jetty）里已经有
注解辅助编译	`org.projectlombok:lombok`	编译期需要，运行时无意义
插件/SDK 开发	`com.google.auto.service:auto-service`	编译时生成 META-INF 文件，运行时由宿主加载
SPI 或接口框架	`provided` 类库	由运行时平台提供

在 Maven 中类似的 scope 是：

Gradle 的优点是 更细粒度、更模块化，Maven 的 provided 在多模块项目中往往语义不够清晰。